================================================================
  Tomb Raider: Legend VR - Controller Bindings
================================================================

The VR controllers send the game's normal keyboard and mouse controls.
The keyboard and mouse continue to work at the same time. The layout is the
same under OpenXR (the default) and OpenVR (the fallback).

SETTINGS PANEL (1.1.0)
----------------------
Reverb G2, WMR, Index   Hold both sticks in for 0.6 s
Oculus Touch            Hold the left menu button (a tap pauses)
Keyboard                Insert
In the panel: point with your main hand and pull the trigger, or left stick
moves, A selects, B goes back, right stick scrolls. The same gesture closes
it.


HP REVERB G2 / OCULUS TOUCH
----------------------------
Left stick                  Move Lara (W / A / S / D)
Left stick short click      Gear menu: push the stick towards an item
                            (up health pack, right binoculars,
                            down switch weapon, left personal light);
                            in menus: back (Escape)
Left stick double click     Recenter the VR view
Left stick long click       Pause (Escape); Oculus Touch: left menu button

Right stick                 Turn the camera (mouse movement)
Right stick short click     Switch weapons (End)
Right stick double click    Open the PDA (Tab)
Right stick long click      Use binoculars (Page Down)

Left trigger                Action / interact / pull grapple (E)
Right trigger               Fire (left mouse); menu select (Enter)
Left grip                   Throw grapple (Q)
Right grip                  Combat lock-on (G)

Right A                     Jump / surface (Space); menu select (Enter)
Right B                     Dive (F); menu back (Escape)
Left X                      Accurate/free aim (Z)
Left Y short press          Grenade / flare (K)
Left Y long press           Personal light / flashlight (Delete)
Left Y held                 Board mode: flick Lara over (board_god_hand)


VALVE INDEX CONTROLLERS
-----------------------
Left joystick               Move Lara (W / A / S / D)
Left joystick short click   Gear menu (push the joystick towards an
                            item, as above); in menus: back (Escape)
Left joystick double click  Recenter the VR view
Right joystick              Turn the camera (mouse movement)
Right joystick click        Switch weapons (End)
Right joystick double click Open the PDA (Tab)

Left trigger                Action / interact / pull grapple (E)
Right trigger               Fire (left mouse); menu select (Enter)
Left grip                   Throw grapple (Q)
Right grip                  Combat lock-on (G)

Right A                     Jump / surface (Space); menu select (Enter)
Right B                     Dive (F); menu back (Escape)
Left A                      Accurate/free aim (Z)
Left B short press          Grenade / flare (K)
Left B long press           Personal light / flashlight (Delete)
Left B held                 Board mode: flick Lara over (board_god_hand)
Left trackpad click         Pause (Escape)
Right trackpad click        Use binoculars (Page Down)


ORIGINAL WINDOWS MIXED REALITY CONTROLLERS
------------------------------------------
Left joystick               Move Lara (W / A / S / D)
Left joystick short click   Gear menu (push the stick towards an item);
                            in menus: back (Escape)
Left joystick double click  Recenter the VR view
Left joystick long click    Pause (Escape)

Right joystick              Turn the camera (mouse movement)
Right joystick short click  Switch weapons (End)
Right joystick double click Open the PDA (Tab)
Right joystick long click   Use binoculars (Page Down)

Left trigger                Action / interact / pull grapple (E)
Right trigger               Fire (left mouse); menu select (Enter)
Left grip                   Throw grapple (Q)
Right grip                  Combat lock-on (G)

Right trackpad click        Jump / surface (Space); menu select (Enter)
Left trackpad click         Dive (F); menu back (Escape)
Left application/menu       Accurate/free aim (Z)
Right menu short press      Grenade / flare (K)
Right menu long press       Personal light / flashlight (Delete)
Right menu held             Board mode: flick Lara over (board_god_hand)


MENU CONTROLS
-------------
Left stick                  Navigate (arrow keys)
Jump button                 Select (Enter)
Right trigger               Select (Enter)
Dive button                 Back (Escape)
Pause button                Back (Escape)

The same SteamVR action set remains active in gameplay and menus. This avoids
the separate menu-binding set that some controllers left completely unbound.


OPTIONAL IMMERSIVE MODE
-----------------------
Set this in trlvr.ini and restart the game:

    [controls]
    immersive_controls = 1

Right stick long press      Switch first / third person (\ on the keyboard)

FIRST PERSON (also set [vr] first_person = 1, first_person_tracked_hands = 1)
The grips become your hands; changes from the tables above:
  * Pistols: grip at a hip to draw (akimbo draws both); grip there again to
    holster. Grip over a shoulder to draw or swap to the long gun; the other
    hand on its foregrip holds it two-handed.
  * Belt: grab the grapple (fling and let go to throw) or the binoculars
    (bring them to your face). Pouches: grenade/flare at the front of the belt
    (fling to throw), medipack on the right chest (bring it to your mouth).
    The pouches show the game's own models while you carry any.
  * Personal light: left grip at the left chest.
  * Action trigger: precision aim with guns out, otherwise Action (E). With the
    grapple attached, hold a trigger and pull your hand back to yank.
  * Climbing: grip ledges, vines, chains and bars; pull to move, pull down
    with both hands to climb up.
  * X, Y long press and right stick long press are not used (the gestures
    above replace them). The right stick turns smoothly or in snaps
    (turn_mode). left_handed = 1 swaps the triggers' roles.

THIRD PERSON
The full button layout above still works. In addition a floating gear cross
of the game's own item icons sits in front of you: grip an icon to use it,
grip its centre handle to move the cross. The left grip at the left chest
toggles the light. With [controls] gear_menu = radial the cross is replaced
by the hold-and-push gear menu of the classic layout.

In first person, pause menu > VR Settings > VR Holster Setup places the
holsters, belt gear and pouches for your body: hold each item where you want
it and pull the trigger.

Pause menu > VR Settings > Hand Calibration lines Lara's hands up with your
controllers: move each controller into the held-out hand and squeeze its
grip (locking both saves). Then, in first person, aim your pistol at the
target and pull the trigger to set your aim. A skips a step (keeping what
you had); the menu button stops.


NOTES
-----
* A long press is approximately 0.65 seconds.
* F1 on the keyboard recentres the view. Double-clicking the left stick does
  the same from every supplied VR controller binding.
* If the long-press actions do not appear, SteamVR may have retained an older
  or custom binding. Open SteamVR > Settings > Controllers > Manage Controller
  Bindings and select/reset to the supplied Tomb Raider: Legend VR binding.
* Tutorial and contextual prompts translate the game's coloured keyboard token
  to the matching VR control name. Normal prose is left untouched.
